home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / misc / amag / AM9409_2.lha / ARexxManager / ArexxManager.executable / ReadMe.dok.2.1 < prev    next >
Text File  |  1994-07-28  |  18KB  |  377 lines
  1.  
  2.  
  3.  
  4.  
  5.                  =========================================
  6.                  ||                                     ||
  7.                  ||   A r e x x M a n a g e r   2 . 1   ||
  8.                  ||                                     ||
  9.                  =========================================
  10.  
  11.  
  12.  
  13.  
  14.                          Autor: Karsten Wysocki
  15.                                 An der Mühle 3
  16.                                 38372 Büddenstedt
  17.  
  18.                    Entwicklungswerkzeug: ArexxManager
  19.  
  20.  
  21.  
  22.  
  23.   ArexxManager 2.1 ist ein Update zu ArexxManager.
  24.  
  25.   Für Benutzer der vorherigen Version:
  26.       Beachten Sie Bitte die Änderungen und Ergänzungen:
  27.                  ArexxShell: Beispiele und nachfolgende Absätze
  28.               ScriptManager: [Edit]
  29.                            & [Launch]
  30.                            & [VCopy] <- NEU!!!
  31.             ResourceManager: [Add Lib]
  32.                            & [Libs] <- früher Show Libs
  33.  
  34.   Weitere Änderungen zur Vorversion:
  35.       - Bessere Editiermöglichkeiten in der ArexxShell (wie in DOS-Shell).
  36.       - Die Datei-Requester des Script-Managers sind nicht mehr auf das
  37.         REXX:-Verzeichnis fixiert. Der ScriptManager merkt sich das zu-
  38.         letzt benutzte Verzeichnis und den Dateinamen.
  39.       - Die Launch-Funktion des ScriptManagers erzeugt nur noch dann ein
  40.         Ausgabefenster, wenn Fehler im Programm auftreten oder vom Pro-
  41.         gramm Ausgaben erzeugt werden.
  42.       - Neue Funktion in ScriptManager: [VCopy] (siehe Beschreibung)
  43.       - Die vom ResourceManager erzeugten Listen der Show-Funktionen wer-
  44.         den jetzt alphabetisch sortiert und lassen sich bei Überlänge Sei-
  45.         weise durchblättern. Die einzige Ausnahme ist die Funktion [Libs],
  46.         die Liste der Libraries wird in der Such-Reihenfolge für Funkti-
  47.         onsaufrufe ausgegeben.
  48.       - Code-Optimierung bei allen Komponenten des ArexxManagers
  49.  
  50.  
  51.  
  52.  
  53.   Einleitung:
  54.   ===========
  55.   Der ArexxManager ist ein Werkzeug für angehende und professionelle
  56.   Arexx-Programmierer. ArexxManager ist ein komplett in Arexx program-
  57.   miertes und multitasking-fähiges Programmsystem. Es besteht aus drei
  58.   im multitasking laufenden Komponenten. Das Programm ArexxShell erzeugt
  59.   zwei Fenster, eins zu Ausgabe und eins zur Eingabe. Damit können inter-
  60.   aktiv Arexx-Kommandos und Library-Funktionen getestet werden. Mit dem
  61.   Programm ScriptManager können Arexx-Scripts verwaltet, bearbeitet und
  62.   getestet werden. Der ResourceManager ermöglicht es dem Arexx-Programmie-
  63.   rer die Arexx-Resourcen auf bequeme Art einzusehen und zu verwalten. Auch
  64.   die Arexx-Trace-Console (TCO, TCC) läßt sich hiermit aktivieren und de-
  65.   aktivieren. Das vierte Programm, ArexxManager, gibt dem Benutzer die Mög-
  66.   lichkeit alle drei System-Komponenten bequem gleichzeitig mit einem Mouse-
  67.   click zu starten. Die Programme können jedoch auch einzeln gestartet und
  68.   benutzt werden.
  69.  
  70.   ArexxManager benutzt die rexxapp.library von Jeff Glatt (erhältlich z.B.
  71.   auf Fish-Disk 463) und die apig.library von Ronnie E. Kelly (erhältlich
  72.   z. B. auf Fish-Disk 634). Laut beiliegendem Text wird die apig.library
  73.   von Ronnie E. Kelly zu Public Domain erklärt und ist frei kopierbar und
  74.   benutzbar. Zur Veröffentlichung der rexxapp.library wurden keinerlei An-
  75.   gaben betreffs der Urheberrechte gemacht.
  76.  
  77.  
  78.  
  79.  
  80.   Systemvoraussetzungen:
  81.   ======================
  82.   Um ArexxManager zu benutzen benötigen Sie System 2.x oder höher.
  83.   Arexx muß installiert sein. Das heißt, in der Startup-Sequence muß
  84.   der Arexx-Handler (RexxMast) gestartet werden, die Arexx-Programme im
  85.   REXXC-Verzeichnis des Systems müssen vorhanden sein und das Verzeichnis
  86.   muß als Pfad in der Startup-Sequence eingetragen sein (path sys:rexxc add),
  87.   die Arexx-Libraries (rexxsyslib.-, rexxsupport.- und rexxhost.library)
  88.   müssen sich im LIBS:-Verzeichnis befinden und es muß ein Verzeichnis für
  89.   Arexx-Scripts existieren, daß in der Startup-Sequence oder im User-Startup
  90.   als REXX: assigned sein muß (assign REXX: laufwerkname:pfad).
  91.  
  92.  
  93.  
  94.  
  95.   Installation:
  96.   =============
  97.   Schieben Sie die ArexxManager-Schublade von der Diskette in ein von Ihnen
  98.   gewünschtes Festplattenverzeichnis. Um bequem mit ArexxManager arbeiten zu
  99.   können, aktivieren Sie die ArexxMananger-Schublade im Festplattenverzeich-
  100.   nis und wählen dann in der Workbench-Titelleiste "Icons/Leave out". Nun ha-
  101.   ben Sie die ArexxManager-Schublade direkt auf der Workbench. Positionieren
  102.   Sie die Schublade und fixieren Sie sie dann mit "Icons/Snapshot". Öffnen
  103.   Sie nun die ArexxManager-Schublade und doppelklicken Sie das CopyLib-
  104.   Icon. Nun wird die von ArexxManager benötigte apig.library in Ihr LIBS:-
  105.   Verzeichnis kopiert.
  106.  
  107.   Danach ist die Installation abgeschlossen.
  108.  
  109.  
  110.  
  111.  
  112.   Programmbeschreibungen:
  113.   =======================
  114.  
  115.  
  116.   ArexxManager:
  117.   -------------
  118.   Der ArexxManager dient zum gleichzeitigen Starten der einzelnen Programme
  119.   ArexxShell, ScriptManager und ResourceManager. Diese Komponenten können
  120.   jedoch auch einzeln über Ihr eigenes Icon gestartet und benutzt werden.
  121.  
  122.  
  123.   ArexxShell:
  124.   -----------
  125.   Die Benutzeroberfläche von ArexxShell besteht aus zwei Fenstern. Im Einga-
  126.   be fenster können Arexx-Kommandos und Funktionsaufrufe eingegeben werden.
  127.   Das Ergebnis erscheint dann im Ausgabefenster. Ausgegeben werden jeweils
  128.   das Ergebnis des Kommandos, die Adresse an die das Kommando geschickt wur-
  129.   de, der ReturnCode (RC) und das zurückgelieferte Resultat (RESULT). Im
  130.   Fehlerfall erscheint die entprechende Arexx-Fehlermeldung.
  131.  
  132.   Eingaben, die in der ArexxShell fehlerfrei abgearbeitet wurden, können
  133.   Sie mit der gleichen Syntax in Ihrem Arexx-Programm-Code verwenden. Da-
  134.   durch eignet sich die ArexxShell besonders für angehende Arexx-Program-
  135.   mierer sehr gut zum Experimentieren.
  136.  
  137.   Beispiele:
  138.             Eingabe: say "Hallo"
  139.             Ausgabe: Hallo
  140.                      ADDRESS:REXX
  141.                      RC:0  Result:
  142.  
  143.             Eingabe: say show(files)
  144.             Ausgabe: STDOUT STDIN
  145.                      ADDRESS:REXX
  146.                      RC:0  Result:
  147.  
  148.             Eingabe: say show(
  149.             Ausgabe: +++ Error 42 in Line 1: Unbalanced parentheses
  150.                      Command returned 10/42: Unbalanced parentheses
  151.                      rx failed returncode 10
  152.  
  153.             Eingabe : address command dir
  154.             Ausgabe :     ArexxManager2.1(dir)
  155.                        apig.library                 ArexxManager2.1
  156.                        ArexxManager2.1.info         ArexxShell2.1
  157.                          .                            .
  158.                          .                            .
  159.                          .                            .
  160.  
  161.                       ADDRESS:COMMAND
  162.                       RC:0  RESULT:RESULT
  163.  
  164.             Eingabe: address 'ScriptManager' 'DIE'
  165.                Diese Message veranlaßt den ScriptManager sich selbst
  166.                zu beenden und das ScriptManager-Fenster schließt sich.
  167.             Ausgabe: ADDRESS:'SCRIPTMANAGER'
  168.                      RC:0  RESULT:RESULT
  169.  
  170.          Starten des Echtzeitvideodigitzers VLab, danach:
  171.             Eingabe: address vlab
  172.             Ausgabe: ADDRESS:VLAB
  173.                      RC:0  Result:
  174.             Eingabe: 'aslrequest "files"'
  175.                Daraufhin produziert VLab einen Datei-Requester,
  176.                nach Auswahl der Datei "Ram Disk:IFR.0006" aus dem Requester:
  177.             Ausgabe: ADDRESS:VLAB
  178.                      RC:0  Result:Ram Disk:IFR.0006
  179.  
  180.   Es ist auch möglich eine ganze Folge von Kommandos einzugeben. Dabei ver-
  181.   wendet man das Semikolon als Trennzeichen. Die Eingabe
  182.                      address vlab;'aslrequest "files"'
  183.   ergibt dann das gleiche Ergebnis wie das obenstehende Beispiel. Anbei ein
  184.   kleiner Tip: Das Hochkomma (') verbirgt sich auf der deutschen Tastatur
  185.   unter Alt/Ä.
  186.  
  187.   Fehlerhafte Eingaben können mit der Backspace- oder den Cursor- und der
  188.   Del-Taste korrigiert werden. Mit der Tasten Cursor-Up und Cursor-Down
  189.   können Sie Ihre letzten Eingaben zurückholen.
  190.  
  191.   Verlassen können Sie die ArexxShell durch Eingabe von exit oder x.
  192.   Das Ausgabefenster schließt sich dann nach ca. 2 Sekunden automatisch.
  193.  
  194.  
  195.   ScriptManager:
  196.   --------------
  197.   Der ScriptManager dient zum Verwalten und Bearbeiten Ihrer Arexx-Scripts.
  198.   Alle Gadgets im ScriptManager erzeugen einen Datei-Requester. Erst nach
  199.   Auswahl einer Datei aus dem Requester wird die gewählte Funktion ausge-
  200.   führt. Bei Wahl von [Delete] (Löschen), erscheint nach der Auswahl von
  201.   Dateien zusätzlich ein Sicherheits-Requester mit dem Sie das Löschen der
  202.   Dateien explizit bestätigen müssen. In den Datei-Requestern ist das Ver-
  203.   zeichnis REXX: für Arexx-Scripts voreingestellt.
  204.  
  205.   Beschreibung der einzelnen Funktionen:
  206.  
  207.   [Edit] Dient zum Editieren von Arexx-Scripts. Nach Auswahl eines Scripts
  208.          aus dem Datei-Requester wird ein Editor gestartet mit dem man das
  209.          im Requester auswählte Script editieren kann. Beim Erststart von
  210.          ScriptManager ist als Editor ED voreingestellt. Wenn Sie einen
  211.          anderen Editor bevorzugen, können Sie den von Ihnen gewünschten
  212.          Editor mit dem Gadget [Change Editor] dauerhaft einstellen.
  213.          Wenn Sie im Datei-Requester keine Datei auswählen und statt
  214.          [Cancel] [ OK ] drücken, wird der Editor auch gestartet, jedoch
  215.          keine Datei geladen.
  216.          Noch ein Tip: Der Arexx-Interpreter ist nicht in der Lage Programme
  217.          zu laden, in deren Namen Leerzeichen vorkommen. Achten Sie also
  218.          beim Speichern Ihrer Arexx-Scripts mit Ihrem Editor darauf, keine
  219.          Programmnamen die Leerzeichen enthalten zu vergeben.
  220.  
  221.   [Launch] Mit dieser Funktion können Sie Ihre Arexx-Scripts starten.
  222.          Wenn in Ihrem Script ein Fehler auftritt, oder Sie z.B. mit den
  223.          Kommandos SAY oder ECHO eine Ausgabe erzeugen, wird ein Fenster
  224.          geöffnet in dem die Fehlermeldung bzw. Ihre Ausgabe erscheint. Im
  225.          Kopf des Ausgabe-Fensters ist der Name des dazugehörigen Arexx-
  226.          Programms eingetragen. Wenn Ihr Arexx- Programm beendet ist und Sie
  227.          das Ausgabe-Fenster nicht mehr benötigen, können Sie es mit dem
  228.          Close-Gadget in der linken oberen Ecke schließen.
  229.          Falls Sie in Ihrem Programm Benutzereingaben anfordern wollen, ist
  230.          es zu empfehlen, nach folgendem Beispiel ein eigenes Fenster zu
  231.          öffnen:
  232.                 x = open(outwin,"CON:0/0/400/100/MeinFenster/SMART")
  233.          Eingaben können Sie dann mit der readline-Funktion anfordern:
  234.                 eingabe = readln(outwin)
  235.          Für Ausgaben benutzen Sie dann die writeline-Funktion
  236.                 writeln(outwin,ausgabe)
  237.  
  238.   [Delete] Damit können Sie in Ihrem Script-Verzeichnis aufräumen. In dem
  239.          erscheinenden Datei-Requester sind mehrere Dateien auswählbar. Nach
  240.          dem Drücken des [ OK ]-Gadgets bekommen Sie zusätzlich einen Sich-
  241.          erheits-Requester in dem alle ausgewählten Dateien nochmals aufge-
  242.          listet sind. Erst wenn Sie jetzt nochmals [ OK ] drücken, werden die
  243.          aufgelisteten Dateien gelöscht. Das Löschen der Dateien kann sowohl
  244.          im Datei-Requester als auch im Sicherheits-Requester durch Auswahl
  245.          von [Cancel] abgebrochen werden.
  246.  
  247.   [Editor] Beim Erststart des ScriptManagers ist als Editor ED vorein-
  248.          gestellt. Wenn Sie einen anderen Editor bevorzugen, können Sie die-
  249.          sen mit der Funktion Editor dauerhaft einstellen. Auch das
  250.          Wechseln des aktuell eingestellten Editors ist jederzeit möglich.
  251.          Nach Anwahl von [Editor] erscheint ein Datei-Requester mit
  252.          dem Sie den von Ihnen gewünschten Editor auswählen können. Nach dem
  253.          Drücken des [ OK ]-Gadgets wird dieser Editor zukünftig zum Bearbei-
  254.          ten Ihrer Scripts für die Funktion [Edit] verwendet.
  255.  
  256.   [Icon] Damit können Sie Ihre Arexx-Scripts mit einem Icon versehen,
  257.          damit Sie Ihre Arexx-Programme auch von der Workbench mit einem
  258.          Maus-Doppelklick starten können. Wenn Sie das erstellte Icon mit
  259.          der Maus einmal anklicken und dann in der Worbench-Titelleiste
  260.          "Icons/Information" wählen, werden Sie feststellen, daß als Tool-
  261.          Type "CONSOLE=NIL:" eingetragen ist. Das bewirkt, daß das von Rx
  262.          beim Script-Start erzeugte Rx_Out-Fenster unterdrückt wird. Wenn
  263.          Sie jedoch das Rx_Out-Fenster für Aus- oder Eingaben Ihres Arexx-
  264.          Programms benötigen (z.B. Say, Echo, und Pull benutzen dieses Fen-
  265.          ster), löschen Sie das Tool-Type.
  266.  
  267.   [VCopy] Mit dieser Funktion haben Sie die Möglichkeit von dem im
  268.          erscheinenden Datei-Requester ausgewählten Script eine Versions-
  269.          Kopie zu erstellen. Das Script wird mit dem gleichen Namen kopiert
  270.          und eine Versionsnummer angehängt (z.B wird "MyScript" nach
  271.          "MyScript.1" kopiert). Wenn eine Versionsnummer vorhanden ist wird
  272.          diese um eins erhöht. Es werden dabei auf keinen Fall Dateien über-
  273.          schrieben. Falls schon eine Datei mit der neuen Versionsnummer vor-
  274.          handen ist, wird die Versionsnummer solange erhöht, bis die neue
  275.          Version kopiert werden kann ohne eine Datei zu überschreiben.
  276.  
  277.  
  278.   ResourceManager:
  279.   ----------------
  280.   Mit diesem Programm ist es Ihnen möglich die Arexx-Resourcen einzusehen
  281.   und zu verwalten. Alle mit den Show-Funktionen erzeugten Listen werden
  282.   zur besseren Orientierung alphabetisch sortiert. Lediglich die Funktion
  283.   [Libs] bildet hierbei eine Ausnahme. Die Libraries werden in der
  284.   Such-Reihenfolge aufgelistet. Damit kann man bei Libraries mit gleichen
  285.   Funktionsnamen nachvollziehen, welche Library benutzt wurde.
  286.   Auch das Öffnen und Schließen der Trace-Console (TCO,TCC) wird hier auf
  287.   Knopfdruck ermöglicht.
  288.  
  289.   Zusätzliche Information zum Tracing:
  290.          Verwenden Sie TS (Tracing im Single-Step) nicht zusammen mit
  291.          ArexxManager! Wenn Sie TS starten, gilt der Single-Step-Modus
  292.          für alle laufenden Arexx-Programme, also auch für ArexxManager!
  293.          Aus diesem Grund sind auch nur TCO und TCC im ArexxManager
  294.          implementiert.
  295.  
  296.   Beschreibung der einzelnen Funktionen:
  297.  
  298.   [Trace ON] Einschalten des Trace-Modus (TCO). Es wird eine Trace-Console
  299.          erzeugt, auf der mögliche Fehler in Ihren mit dem ScriptManager ge-
  300.          starteten Arexx-Programmen ausgegeben werden.
  301.  
  302.   [Trace OFF] Auschalten des Trace-Modus (TCC). Die Trace-Console wird ge-
  303.          schlossen. Wenn keine Fehler aus voherigen Programmläufen angezeigt
  304.          wurden, schließt sich die Trace-Console sofort. Falls während des
  305.          Betriebes der Trace-Console Fehler aufgetreten sind, schließt sich
  306.          die Trace-Console erst nach Beendigung der fehlerhaften Arexx-Pro-
  307.          gramme.
  308.  
  309.   [Add Lib] Damit lassen sich zusätzliche Arexx-Funktions-Libraries zu der
  310.          aktuellen Liste hinzufügen. Es erscheint ein Datei-Requester, der
  311.          auf das LIBS:-Verzeichnis voreingestellt ist und Sie dazu auffor-
  312.          dert die von Ihnen gewünschte Arexx-Library auszuwählen.
  313.  
  314.          Erst nachdem eine Arexx-Library in der Library-Liste eingetragen
  315.          ist, können die Library-Funktionen von Arexx-Programmen benutzt
  316.          werden. Dieses entspricht der Arexx-Funktion addlib(). Dabei ist
  317.          zu beachten, daß die mit [Add Lib] hinzugefügten Libraries mit dem
  318.          Standard-Offset "-30" in die Liste eingetragen werden. Wenn Sie also
  319.          eine Library mit einem ungewöhnlichen Offset aufsetzen möchten,
  320.          sollten Sie dies entweder mit
  321.                     call addlib("libraryname",prio,offset,version)
  322.          in der ArexxShell bzw. einem Arexx-Programm oder mit RXLIB von der
  323.          DOSShell aus tun. Ein falscher Library-Offset kann einen Rechnerab-
  324.          sturz verursachen.
  325.  
  326.          Weiterhin gilt es zu bedenken, daß unter Umständen mehrere Arexx-
  327.          Libraries gleichlautende Funktionen besitzen können. Das kann zu
  328.          Fehlern in Arexx-Programmen führen, die dann beim Aufruf solcher
  329.          Funktionen die falsche Library benutzen könnten.
  330.  
  331.   [Rem Lib] Zum Entfernen von Arexx-Libraries aus der Library-Liste.
  332.          Auch hierbei erscheint ein Datei-Requester, der das LIBS:-Verzeich-
  333.          nis auflistet. Die von Ihnen ausgewählte Library wird nach dem
  334.          Drücken von [ OK ] aus der Library-Liste entfernt, sofern Sie dort
  335.          eingtragen ist. Die Library wird NICHT im LIBS:-Verzeichnis ge-
  336.          löscht, sondern nur aus der sich im Arbeitsspeicher befindlichen
  337.          Arexx-Library-Liste herausgenommen. Die apig.library und die
  338.          rexxsupport.library lassen sich allerdings nicht entfernen, sie wer-
  339.          den vom ArexxManager benutzt.
  340.  
  341.   [Libs] Zeigt die aktuelle Library-Liste. Die Ausgabe ist nach der
  342.          Such-Reihenfolge sortiert, d.h. bei gleichlautenden Funktionen in
  343.          mehreren Libraries wird die am weitesten oben stehende Library be-
  344.          nutzt.
  345.  
  346.   [Clips] Listet die aktuelle Clip-Liste auf.
  347.  
  348.   [Ports] Erzeugt eine Auflistung aller aktuellen Arexx-Ports.
  349.          Auch die Ports des ArexxManagers sind in dieser Liste zu finden. Sie
  350.          werden benötigt um die Mouseclicks in den Requestern und Fenstern
  351.          des ArexxManagers an die laufende Applikation zu senden.
  352.  
  353.   [Files] Listet alle geöffneten logischen Dateien auf.
  354.  
  355.   [Ready] Zeigt eine Liste aller Tasks, die sich im READY-Status befinden.
  356.  
  357.   [Waiting] Erzeugt eine Auflistung der Tasks, die sich im WAITING-Status
  358.          befinden.
  359.  
  360.  
  361.  
  362.  
  363.   Nachwort:
  364.   =========
  365.   Zusätzliche Informationen zu den oben erwähnten und teilweise beschriebenen
  366.   Arexx-Funktionen sowie den Arexx-Tools RX TCC TCO und TS des REXXC:-Ver-
  367.   zeichnisses finden Sie in Ihrem Handbuch zur Systemsoftware im Abschnitt
  368.   "Zusätzliche Dienstprogramme".
  369.  
  370.   Für Bugreports und weitere Anregungen wäre ich sehr dankbar.
  371.   Nachstehend meine Adresse:
  372.  
  373.                             Karsten Wysocki
  374.                             An der Mühle 3
  375.                             38372 Büddenstedt
  376.  
  377.